home *** CD-ROM | disk | FTP | other *** search
/ MacHack 2000 / MacHack 2000.toast / pc / The Hacks / Genie / Projects / A-line / Documentation / Installation < prev    next >
Encoding:
Text File  |  2000-06-24  |  4.6 KB  |  112 lines

  1. A-line Installation
  2. ===================
  3.  
  4. Introduction
  5. ------------
  6.  
  7. If this looks like a pain, that's because it is.  But now it's a pain that includes detailed documentation, which was not always the case.  Eventually the nasty bits will be automated.
  8.  
  9. Hey, at least *you* didn't have to *invent* the damn thing. :-)
  10.  
  11. Prerequisites
  12. -------------
  13.  
  14. Development tree:
  15.  
  16. I recommend that you create a folder called Tools inside a folder called Development, and in the Tools folder put MPW, Interfaces&Libraries, and MacPerl ƒ.  If the development folder is not at the root level of your startup disk, then make an alias to it (called Development) at the root level of the startup disk.
  17.  
  18. MPW:
  19.   * Get the MPW disk_image_ <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM_Images/MPW-GM.img.bin> from Apple.
  20.   * Mount the image and copy the MPW folder onto your hard disk.  Copy the Interfaces&Libraries folder as well.
  21.   * Consider downloading MPW components that have been updated since the last CD.
  22.  
  23. MacPerl:
  24.   * Get MacPerl_ <http://www.macperl.com/>.
  25.   * Get the MacPerl MPW tool.
  26.   * Run the MacPerl installer, and then the tool installer.
  27.   * Run the MacPerl tool Install script in MPW Shell.  (Follow the instructions.)
  28.   * Edit the 'Perl' MPW startup script.  Where MACPERL is set, replace "<your disk's name>:" with "{BOOT}".   (This is optional, but recommended.)  [Do we need to change PERL5LIB?]
  29.   * Quit and relaunch MPW Shell.
  30.  
  31. Installation
  32. ------------
  33.  
  34. A-line:
  35.   * Run Install-Aline using the full path.  You can do this by dragging the file into a worksheet window to insert the pathname.  Then triple-click the line and hit Enter on the keypad.
  36.   * Quit and relaunch MPW Shell.
  37.  
  38. Here's what Install-Aline does:
  39.   * Makes an alias of its UserStartup script in MPW's 'Startup Items' folder.
  40.   * Creates a folder called 'Development' at the root of the boot volume, if it doesn't already exist.  If you wish to use a different folder, then make it yourself and make an alias to it called 'Development' before you run Install-Aline.
  41.   * Makes an alias of its Scripts folder in the Development folder.
  42.   * Creates a folder called 'Menu' in the Development folder.
  43.  
  44. The A-line install script requires that the MPW Perl tool be installed, and will complain if it's not.
  45.  
  46. Postrequisites
  47. --------------
  48.  
  49. CodeWarrior tools:
  50.   * Copy the CodeWarrior tools and libraries using one of Metrowerks' supplied scripts.  As of 2000-03-08 you'll need them for compiling the projects that use A-line.
  51.  
  52. Library targets:
  53.   * Make a folder called 'Libraries'.  A good location is in a folder 'Projects' in the Development folder.
  54.   * Inside Libraries, make new folders '68KLibraries', 'MPW68KLibraries', 'MW68KLibraries', 'MWPPCLibraries', 'PPCLibraries', and 'SharedLibraries'.
  55.   * Make aliases to each of these folders in the Menu folder.
  56.   * Inside each of those same folders, make a folder called '<Libraries>'.
  57.   * Place aliases in the respective <Libraries> folders to the various libraries in the Interfaces&Libraries folder, as follows:
  58.     Libraries:
  59.         MWPPCLibraries:
  60.             <Libraries>:
  61.                 (from :Libraries:MWPPCLibraries:)
  62.                 MSLAppRuntime.Lib        ->    MSL AppRuntime.Lib
  63.                 MSLC++.PPC.Lib            ->    MSL C++.PPC.Lib
  64.                 MSLC.PPC.Lib            ->    MSL C.PPC.Lib
  65.                 MSLRuntimePPC.Lib        ->    MSL RuntimePPC.Lib
  66.                 MSLSIOUX.PPC.Lib        ->    MSL SIOUX.PPC.Lib
  67.                 PLStringFuncsPPC.lib
  68.         PPCLibraries:
  69.             <Libraries>:
  70.                 (from :Libraries:PPCLibraries:)
  71.                 PPCToolLibs.o
  72.         SharedLibraries:
  73.             <Libraries>:
  74.                 (from :Libraries:SharedLibraries:)
  75.                 InterfaceLib
  76.                 MathLib
  77.                 ObjectSupportLib
  78.         MW68KLibraries:
  79.             <Libraries>:
  80.                 (from :Libraries:MW68KLibraries:)
  81.                 MacOS.lib
  82.                 MathLib68K(4i_8d).Lib    ->    MathLib68K (4i_8d).Lib
  83.                 MathLib68KFa(4i_8d).Lib    ->    MathLib68K Fa(4i_8d).Lib
  84.                 MSLC++.68K(4i_8d).Lib    ->    MSL C++.68K (4i_8d).Lib
  85.                 MSLC++.68KFa(4i_8d).Lib    ->    MSL C++.68K Fa(4i_8d).Lib
  86.                 MSLC.68K(4i_8d).Lib        ->    MSL C.68K (4i_8d).Lib
  87.                 MSLC.68KFa(4i_8d).Lib    ->    MSL C.68K Fa(4i_8d).Lib
  88.                 MSLRuntime68K.Lib        ->    MSL Runtime68K.Lib
  89.                 MSLSIOUX.68K.Lib        ->    MSL SIOUX.68K.Lib
  90.                 PLStringFuncs.glue.lib
  91.         68KLibraries:
  92.             <Libraries>:
  93.                 (from :Libraries:Libraries:)
  94.                 AEObjectSupportLib.o
  95.                 ToolLibs.o
  96.         MPW68KLibraries:
  97.             <Libraries>:
  98.                 (from :Libraries:Libraries:)
  99.                 IntEnv.far.o
  100.                 Interface.o
  101.                 MacRuntime.o
  102.                 ToolLibs.far.o
  103.                 (from :Libraries:CLibraries:)
  104.                 CPlusLib.far.o
  105.                 StdCLib.far.o
  106.   * Note that some files have to be renamed to remove spaces.
  107.   * There -- that's it! :-)
  108.   * (This list is under construction.)
  109.  
  110. 1999-05-22:  Inception. [JDJ]
  111. 2000-03-08:  Added sections Introduction, Prerequisites, and Postrequisites.  [JDJ]
  112.